home *** CD-ROM | disk | FTP | other *** search
/ Aminet 44 / Aminet 44 (2001)(GTI - Schatztruhe)[!][Aug 2001].iso / Aminet / mus / misc / NallePUH.readme < prev    next >
Text File  |  2001-07-04  |  5KB  |  127 lines
  1. Short:    Redirects any (hw-banging) sound program to AHI
  2. Author:   Martin Blom <martin@blom.org>
  3. Uploader: Martin Blom <martin@blom.org>
  4. Version:  0.3
  5. Type:     mus/misc
  6. Requires: An MMU, 68020+, AHI v4, OS 3.5 for GUI mode
  7.  
  8. Q: What is "Nalle Puh"?
  9. A: It's the Swedish name for Winnie the Pooh.
  10.  
  11. Q: Really?
  12. A: Yup.
  13.  
  14. Q: But... Ehm. What does this program, "Nalle PUH", do?
  15. A: It's a hack that intercepts some custom chip register accesses and
  16.    turns them into AHI function calls.
  17.  
  18. Q: How?
  19. A: By using the MMU to mark the page at $dff000 as invalid.
  20.  
  21. Q: Invalid? Doesn't that mean you will get an exception each time the OS
  22.    or an application touches the registers?
  23. A: Exactly.
  24.  
  25. Q: Isn't that kind of... slow?
  26. A: You bet.
  27.  
  28. Q: How slow?
  29. A: Unbearable.
  30.  
  31. Q: So the program is useless, then?
  32. A: Not quite. It can be instructed to patch the OS and all applications that
  33.    read or write to the custom chip registers, so that next time the 
  34.    instruction is executed, no exception will be generated.
  35.  
  36. Q: How?
  37. A: A new chip register area is created at $80dff000.  For the kickstart ROM,
  38.    all modules except audio.device will be patched to access this address
  39.    instead of $dff000. For applications, I simply guess when it's ok to
  40.    patch the instructions.
  41.  
  42. Q: Is that fool-proof?
  43. A: Of course not. It's a hack. A proof of concept. Nothing more.
  44.  
  45. Q: Alright then. So what programs can be redirected?
  46. A: I've tried the following programs, and they seem to work:
  47.  
  48.    * audio.device
  49.    * Digibooster 1.7
  50.    * Musicline Editor 1.5
  51.    * Octamed Soundstudio 1.03c
  52.    * Protracker (version 2.3 and 4.0)
  53.    * THX Sound System 2.3d.
  54.  
  55.    I've also tried the following, and they don't:
  56.    
  57.    * Delitracker 2.32
  58.    * Newtracker
  59.    * PlaySID
  60.  
  61.    (Note that Protracker disables multitasking and cannot be used with AHI
  62.    drivers that are not interrupt based.)
  63.  
  64.    Previously, I wrote that Sid4Amiga also could be redirected, which is just
  65.    plain stupid, since Sid4Amiga already uses AHI. Duh! Sorry, Paul.
  66.  
  67. Q: Will you extend Nalle PUH so the all of those program work?
  68. A: Unlikely.
  69.  
  70. Q: Pretty, pretty please!
  71. A: No. The source code is available. Why don't you give it a shot yourself?
  72.  
  73. Q: Because <insert lame excuse here>.
  74. A: Too bad.
  75.  
  76. Q: Suppose I do fix the program, is there anything else I should do?
  77. A: You could certanly improve the instruction patching method. And it could
  78.    also be wise to set up a cachable Chip-RAM mirror so AHI won't have to
  79.    mix the samples from a non-cachable memory area. 
  80.  
  81. Q: Hey! I found a memory leak: You don't close mmu.library! And you don't
  82.    clean up the MMU tables fully either.
  83. A: I know.  The custom chip register mirror must stay if applications were
  84.    patched. mmu.library must not be flushed from memory, or we loose the
  85.    mirror.
  86.  
  87.  
  88. Version history:
  89.  
  90. 0.1, 2001-04-23:    * Initial release.
  91. 0.2, 2001-04-28:    * Redirected logging to the listview in GUI mode.
  92.             * Minor GUI updates.
  93. 0.3, 2001-05-04        * Clears insr. caches when patching applications.
  94.             * Added a few more instr. patches (base relative).
  95.             This means that I had to move the register mirror
  96.             to $e00000. At least that area is unused on my A4000.
  97.             * The GUI does not touch the Paula registers on exit, 
  98.             unless the user has pressed "Test" at least once.
  99.             * Final update! I've returned the sound card I
  100.                         borrowed to write this hack. Thus, no more updates.
  101.  
  102.  
  103. ============================= Archive contents =============================
  104.  
  105. Original  Packed Ratio    Date     Time    Name
  106. -------- ------- ----- --------- --------  -------------
  107.    55972   55972  0.0% 04-May-01 10:44:08 +MuMin.lha
  108.     5488    2436 55.6% 27-Mar-01 22:16:56 +MuMin.readme
  109.     6290    1813 71.1% 14-Apr-01 16:55:32 +CompilerSpecific.h
  110.    19064    7097 62.7% 22-Apr-01 16:15:54 +COPYING
  111.      636     362 43.0% 28-Apr-01 20:19:48 +Makefile
  112.    25744    5627 78.1% 04-May-01 10:43:32 +Nalle.c
  113.      503     275 45.3% 04-May-01 10:43:32 +NallePUH.cd
  114.      368     197 46.4% 23-Apr-01 00:42:28 +NallePUH.h
  115.    24780    7989 67.7% 28-Apr-01 20:19:48 +NallePUH.o
  116.     3290     938 71.4% 04-May-01 10:43:32 +NallePUH.res
  117.     4070    1131 72.2% 04-May-01 10:43:32 +NallePUHstr.s
  118.     6989    6989  0.0% 23-Apr-01 00:42:30 +pooh11.gif
  119.    78004   32734 58.0% 23-Apr-01 00:42:30 +pooh11.o
  120.    50181    9736 80.5% 04-May-01 10:43:32 +PUH.c
  121.     3660    1413 61.3% 28-Apr-01 19:48:32 +PUH.h
  122.     3390    1699 49.8% 04-May-01 10:43:34 +README
  123.   125380   53967 56.9% 04-May-01 10:47:38 +NallePUH
  124.     3390    1699 49.8% 04-May-01 10:41:04 +NallePUH.readme
  125. -------- ------- ----- --------- --------
  126.   417199  192074 53.9% 04-May-101 20:15:22   18 files
  127.